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INTRODUCTION 

Hft'i/BftS is by no means a comprehensive progra» for 
designing high resolution graphics on the TRS-80, However, 
it doss have several features which make it a good addition 
for those with a high resolution board. First is the cost, 
It is absolutely free, If you want to send m a donation, 
that is fine, but 1 ast not asking you to do so. The other 
feature which stakes this prograi of value is the ability for 
you to put text on the graphics screen using DotWriter {1} 
fonts, provided that you own son of them. 

BACK6RQUND 

Being a college student, it took fie quite a while to 
save up enough soney to purchase a high resolution graphics 
board. After 1 bought the board, 1 couldn't really afford 
to buy the drawing progras to go with it, Being a fairly 
decent prograaser, 1 set out to write my own drawing 
program. 1 chose to write it in BASIC because 1 really 
didn't want to take the tins to write assembly language 
routines for several of the features, (Like the trig 
functions needed for drawing circles and such,) So the 
prograa is really very simple in nature. The PRO-DRAW {2} 
progras got around this proble§ by actually loading BASIC 
into aesory and using it's routines, thus saving the author 



1, BotHriter is a Tradiiark of N.K. Bason, Dottlnter is sold 
by ProSoft. 

2, PR0-DRA8 is solo by Nicro Labs, 

By Scott tfelluraey 
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of the proorai from a terrible fate, (trigonometry in 
assesbly language) 

What 1 really recoasend if you are planning on doing a 
lot of drawing, and nant to put Botlriter fonts on the 
graphics screen, is to purchase PRO-DRAW , draw your picture 
or whatever, then use this prograa to add in the text froi 

DotWriter. Because it is written in BASIC, it is really too 
slot* for any serious work. 

Functions 

This progran only supports a iininal aaount of 
functions, They include drawing boxes, circles, lines, 
filling areas, Mock moves, and text entry. This pro§rai 
was never leant to be much, so it doesn't really do much. 
You are totally we kerne to make any additions you say need 
to the proorai, If they work good, send then to m and I 
will aid thea in. 

CURSOR HOVEHENT 

Noi for the nitty gritty. Nhen the pro§rai starts, it 
will CLEAR the graphics screen. If you want to edit the 
current screen, then save it in a file first. After the 
screen clears, you light me it firm southing in the upper- 
left corner, It is just drawing sow shapes which it uses, 



Sy Scott fcturriiy 
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The cursor is a white arrow, which will start in the 

center of the screen, Tryst $e, you can't miss it, The 

arrow aiways points up and to the left. The current point 
on the screen is the point of the arrow. Therefore, if you 
put the current point on the rightmost column of the screen, 
most of the arrow will actually show up on the left side of 
the screen. This is true for the bottom of the screen also, 
(I know, it could get confusing, Just rsnenber, this is 
fres.i 

Now that you know what the cursor is, you need to knot* 

hot* to iove it, This is the easy part. The arret* keys nil I 

move the cursor in any direction one point, (Sorry foils, no 
diagonal oovesent.) Since it would take about half an hour 

to move the cursor across tha screen it this rate, there are 
several other nays to do it, 

You can sove the cursor around the screen by 5 to 8 
dots at a time by holding down SHIFT anil pressing an arrow 
key. This is ituch picker anfl probably the easiest nay to 
get around, But if you need to get ail the way across the 
screen, it still takes tiiti, 

The last fore of cursor novewnt it simple, Press 
CLEAR and an arrow key and the cursor will be moved to the 
farthest point possible in that direction. For exanple, if 
you want to go to the ypper left corner of the serein, hold 
down CLEAR and press the up arrow and the left arret*, 

By Scott HcBurney 
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POINTS 

fts you (Hopefully} know, the graphics serein is 640 
points across and 240 down, and each point cm be on or off. 
The most simple way of changing a point's color is to put 
the point of the cursor on it and press ENTER, 

This mil CQUplment the current point, change it froa 
black to white or white to black, The only problem with 
this is that the points are very stall {try It on a model 
4p'} and it is soaetiaes hard to get the cursor on the exact 
point you writ, (This is where Zoos cones in handy on PRO- 
DRAM, 1 

LINES 

To dra« a line on the screen, aove the cursor to the 
point at which you wish the line to start. Now press the L 
key, (Don't press ENTER unless you are told!) You should 

see the cursor turn into a short diagonal line, Ion, if you 
use the cursor control keys, you can aove the end of that 
line tc inhere ever you want. Notice that the line is sort 
of flashing to 1st you know it is there, 

To put the line there peraanently, you have 3 options. 
One, to Sit the line, or draw a white line, press S, Two, 
to Reset the line, or draw a Mack line, press R. Three, to 
CDiplifient every point on the line, press C, It you change 
your mind, press the SPACE bar and you get your cursor back. 

By Scott HcByrfiiy 
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Reiieiifaer how to Set, Reset, and Conplisent because several 
of the other conanfls t»rt, this nay, 

BOIES 

Boxes cow in handy when drawing things, sc tore the 

cursor to one sndpoint of the box and press B, You can then 
use the cursor keys to change the shape and size of the box 
shown on the screen, Resenber, you want to Set, Reset, or 
Coiipliient the box, or not draw it, 

CIRCLES 

Hicro Labs tricked me on this one, The do not allot* 
you to conplisent circles in BASIC, m f you CAN* T coitpii»fit 
circles in my program, Anyway, put the cursor on the point 
you iish to be the center of the circle, Now press C, You 
will see a stall crosshair pop up, This crosshair mill be 
the approximate siie of your circle. Use the right and left 
cursor keys (uoshifted, shifted or clear) to change the size 
of the crosshair and Set or Reset it, or space to skip it, 

REVERSAL 

You can also coup! went every point on the screen by 
pressing R. The entire serein 15 very quickly reversed in 

color. If you didn't want to do that, just reverse it 
again, If you want to reverse only one area, then hold on 
because 1 will tell you how after you read about block 
moves, 

By Scott ilcBurney 
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F1LL1NB 

You can easily fill an area on the screen with any of 
the 256 available patterns (nusbered through 255) by 

positioning the cursor inside the area to be filled, and 
pressing f, You will he asked for the niaber and then it 
mill fill it, if you press ENTER for the ounber, it won't 
fill it, 

Here are soae handy fill values: 2S5 is white (solid), 

170 is sort of grey, 42 is a variation of gray also, 192 is 
vertical lines, 12? is horizontal lines, and 1 is a bunch of 
evenly spaced dots, iou can play with if and find the 
patterns you like, 

BLOCK MOVES 

ft nice little feature is the ability to take a 
rectangular area on the screen and put it at another 
location on the screen, or even on a different screen, To 
get an area, put the cursor on one of the corners of it and 
press B« Does the box look fasiliar? Use the cursor keys 
to have the box enclose what you want to move. If you don't 
want to do it, press SPACE, Otherwise, press B again to get 
the Mock, 

You can get any sue block you want is long as you 

don't run out of nenory for it, You can only get one block 

at a tue, Memory for the block is allocated dynamically so 

be careful if you Bant to get blocks which are very large. 

By Scott NcBurney 
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By large, 1 aean approaching the siie of the screen, You 

should never want to get the entire screen, That would be 
useless. 

To put your block on the screen, move to the upper left 
corner of where you want it, and press P. The block is put 
onto the screen exactly the way it was taken off, covering 
what ms there before. 

Hers is a neat trick, If you want to reverse the 
colors of an area on the screen, it is very easy, first, 
put the cursor on the upper left corner of the area, Now do 
a get and get the area. Next, reverse the screen, then put 
the area (without moving the cursor anywhere) and reverse 
the screen one sore tiae, 

ERASING 

Say you sade a mistake, You can erase things. Press E 

and an eraser pops up. Using the cursor leys, anything that 
you nave the eraser over will disappear. When you are 
finished erasing, press enter or space and you get your 
cursor tack, I know this isn't good for doing detailed 
work, but it works. 

DISK COMMANDS 

Pressing the D key will bring up a km of cosmands. 
This uenu will alios you to save the current screen or load 
a net* ore, it you do not specify an eKtension on your tile 

By Scott NcBurney 



DRAW/BAS vl.i User Hanual Pap B 

name, the prcgra will isKe It /HR, You nay specify any 
drive to save to also, 

Yoa can also get a directory of all /HR files on disks 
in the disk drives, This option will scan ail drives for 
them. The normal directory option is just that. You tell 
it the drive nutter and it sill show you the directory of 
all visible files. The other options ! think art self 
explanatory, return to the graphics editor or quit to BOS, 

HELP 

Oh yes, if you have a hart tine reassbering these 
coaaands, press the ? ley when the arrow cursor is on the 
screen. This will bring up a help screen which should jar 
your aesory. 

TEIT 

Now m get to the good stuff. Pressing T Mill put you 

in text entry node. Put the cursor in the upper left corner 
of where you. want the first letter, then press T. ft box 
mill be drawn showing the area which the letter Bill tike 
up. The cursor leys will move this box around, so you can 
offset letters. The shifted left and right arrows aove the 
box EXACTLY one letter distance right or left, (Reneitber 
that, it cones in handy') To enter text, just type if. If 
yoa type the wrong letter, you must either erase it later, 
or back up over it and type that sane letter again. 
Pressing enter will go tack to editing. 
By Scott HcBurney 
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Now m get to the test stuff! Entering text using a 
DotWriter font, Put the cursor in the upper lift comer of 
where you want it, and press Y. It nil ask you for the 
name of the font, The font must bs on a disk in one of the 
disk drives, The prograt will thin determine the aaxisus 
sue of the letterset and draw a box of that size. Anything 
in this box could be overwritten when a letter is satie. 

Ydu can aove the box anywhere you want with the cursor 
keys. Typing a letter will invoke a slow process to draw 
that letter or the screen, Please be patient. The original 
routine was written in BASIC and was slow! Thanks to Seorge 
Madison, it is now sachir.e language and is much faster, 

Dotllriter fonts are put on the screen fproportionallyt 
so that they look better. It tool m a while to figure out 
hew to do it, but I did get it to work, jl then found out 
froffl Beorge Madison that there is a such easier way to do it 
if the letterset has been proportional keel,} You can also 
control the aioynt of space noniilty put between lifters, 
To do so, press a nuaber froi (zero) to ? which will be 
sort of the natter of dots between letters, You can only 
change the spacing (pressing through ?) when the arret* 
cursor 15 present, Yoa can not change it once you have 
started entering text, 

Once again, you just press enter to stop entering text 
and you get the trusty arrow cursor back again, 1 sust say, 

By Scott fleSurney 
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■any Ootllriter fonts look very nice on the screen, and they 
can really enhance drawings, 

HIRROR COWHANDS 

tilth Bsorde Madison writing machine language 
subroutines to speed things up, 1 decided to become brave 
and do a little aachine language prograsiing too. Tuo 
machine language subroutines now give us a fast way to flip 
the screw left and right, or top and bottoa, Press M for 
Hirror, then specify Left/right or Top/bottom, The screen 
mill be airrored. If you want to put it back, just mirror 
it again, 

CONCLUSION 

1 hop* that this prograa can be useful to people, I 
have put a lot of work into it, especially with the 
DotWriter section, fts it turned out, the code to ao that 
isn't very long, just sloi. If anyone has any questions, 

comments, ideas, or whatever, 1 can be reached in several 
nays; 



How Address; 
Scott McBurney 
Box 190, Rt. 2 

Manhattan, It 60442 



fiEnie address! 
BITNET address: 
Internet address: 



School Address: 

Scott McBurney 

1602 Ihoiipson Hall 

H.1,0, 

Hacosb, It 61455 

{Until Hay, 1988) 



uny.EDU 



By Scott McBurney 
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60 Minutes of live Mayhem from NLM in 1987 
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I 68 Minutes of live Mayhem from NLM in 1987 

Thermodynamics, Wildest Dreams, Rone With You, 

We Can t, The Great Harlot, The Call, Chosen, 

Closer Than fi Heartbeat, SpeedKiller, Psychotic Wallpaper, 

fill God's Children.,. CLOSEOUT PRICE: $1 



